ip-address

What is ip-address?

The ip-address npm package provides utilities for handling, validating, and manipulating IPv4 and IPv6 addresses in JavaScript. It's useful for applications that need to work with IP addresses, whether it's for networking, security, or data analysis purposes.

What are ip-address's main functionalities?

Parsing and validating IP addresses

This feature allows you to parse and validate IPv4 and IPv6 addresses. The example demonstrates how to create IPv4 and IPv6 objects from string representations of the addresses.

const {IPv4, IPv6} = require('ip-address');
let ipv4 = new IPv4('192.168.0.1');
let ipv6 = new IPv6('2001:0db8:85a3:0000:0000:8a2e:0370:7334');

Checking if an IP address is in a subnet

This feature enables checking if an IP address belongs to a specific subnet. The code sample checks if the '192.168.1.1' address is within the '192.168.1.0/24' subnet.

const {IPv4} = require('ip-address');
let ipv4 = new IPv4('192.168.1.1');
console.log(ipv4.isInSubnet(new IPv4('192.168.1.0/24')));

Converting IP addresses to binary representation

This feature allows converting IP addresses to their binary representation. The example converts the IPv4 address '192.168.1.1' to its binary form.

const {IPv4} = require('ip-address');
let ipv4 = new IPv4('192.168.1.1');
console.log(ipv4.binaryZeroPad());

Other packages similar to ip-address

ip

The 'ip' package provides basic utilities for IP address manipulation, including subnet calculations and IP version checking. It's simpler and has fewer features compared to 'ip-address', which offers more comprehensive IPv6 support and address parsing capabilities.

cidr-js

The 'cidr-js' package is focused on CIDR (Classless Inter-Domain Routing) block calculations, such as checking if an IP address is within a CIDR block. While it overlaps with some functionalities of 'ip-address', it doesn't provide as extensive support for individual IP address manipulations or validations.

README

ip-address

ip-address is a library for validating and manipulating IPv4 and IPv6 addresses in JavaScript.

Documentation

Documentation is available at ip-address.js.org.

Examples

var Address6 = require('ip-address').Address6;

var address = new Address6('2001:0:ce49:7601:e866:efff:62c3:fffe');

address.isValid(); // true

var teredo = address.inspectTeredo();

teredo.client4;    // '157.60.0.1'

Features

• Parsing of all IPv6 notations
• Parsing of IPv6 addresses and ports from URLs with Address6.fromURL(url)
• Validity checking
• Decoding of the Teredo information in an address
• Whether one address is a valid subnet of another
• What special properties a given address has (multicast prefix, unique local address prefix, etc.)
• Number of subnets of a certain size in a given address
• Display methods
  • Hex, binary, and decimal
  • Canonical form
  • Correct form
  • IPv4-compatible (i.e. ::ffff:192.168.0.1)
• Works in node and the browser (with browserify)
• ~1,600 test cases

Used by

• anon which powers @congressedits, among many others
• base85: base85 encoding/decoding
• contrail-web-core: part of Contrail, a network virtualization solution made by Juniper Networks
• dhcpjs: a DHCP client and server
• epochtalk: next generation forum software
• geoip-web: a server for quickly geolocating IP addresses
• hexabus: an IPv6-based home automation bus
• hubot-deploy: GitHub Flow via hubot
• heroku-portscanner: nmap hosted on Heroku
• ipfs-swarm: a swarm implementation based on IPFS
• javascript-x-server: an X server written in JavaScript
• libnmap: a node API for nmap
• mail-io: a lightweight SMTP server
• maxmind-db-reader: a library for reading MaxMind database files
• proxy-protocol-v2: a proxy protocol encoder/decoder built by Ably
• Samsara: a Docker web interface
• sis-api: a configuration management database API
• socks5-client: a SOCKS v5 client
• socksified: a SOCKS v5 client
• socksv5: a SOCKS v5 server/client
• ssdapi: an API created by the University of Portsmouth
• SwitchyOmega: a Chrome extension for switching between multiple proxies with ~311k users!
• swiz: a serialization framework built and used by Rackspace